home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 004 / _spconv / !Spconv / !Help < prev    next >
PGP Signed Message  |  1994-09-29  |  7KB  |  159 lines
  1. -----BEGIN PGP SIGNED MESSAGE-----
  2.  
  3. !Spconv - RISC-OS version (1.00), based on Spconv (version 1.07)
  4. ================================================================
  5.  
  6. Purpose: To convert ZX Spectrum 'snapshot' images to and from different
  7.          formats.
  8.  
  9. Details: A ZX Spectrum 'snapshot' is a memory dump of a ZX Spectrum computer
  10.          suitable for use with a ZX Spectrum emulator (common on most machines
  11.          now). The archimedes has several such emulators (listed below).
  12.          For full documentation, see the documents in the directory 'Doc'
  13.          inside this application. (Hold down SHIFT and double-click on the
  14.          application in a filer window to gain access to it).
  15.          This version is a wimp version for RISC-OS that deals with a drag-
  16.          and-drop interface and a simple dialogue box to choose the format
  17.          to convert to. The original version is a command-line based version.
  18.  
  19.          This main program (SPconv-FE.c) is a front end to 'ROS-Spconv.c'
  20.          (a modified version of 'spconv.c').
  21.  
  22. Usage:   Install the application on the icon bar by 'double-clicking' on the
  23.          application in a filer window.
  24.          Drag a snapshot file of a suitable type (see below for file types)
  25.          onto the icon bar application and a convert dialogue window will
  26.          pop-up.
  27.          Select the file format to convert to.
  28.          Now click on the 'OK' icon to start the conversion.
  29.          (Click on the 'Cancel' icon to abandon the conversion).
  30.          A 'save-as' window will pop-up allowing you to type in a suitable
  31.          filename for your new snapshot file and drag the file onto a filer
  32.          window.
  33.  
  34. Scrap:   RISC-OS must have seen the application !Scrap for this to work, and
  35.          must have read/write access to !Scrap (and sufficient space) for it
  36.          to work. (Good reason to get a hard disc :-)
  37.  
  38. File Types:
  39.          You must 'file-type' your snapshot files for them to be accepted.
  40.          I have use the following file types for the moment, based on the
  41.          types used in the Spectrum emulators for RISC-OS machines...
  42.  
  43.          SNA         :  CEF   (SNA snapshot, filetype from !MZX)
  44.          Z80         :  CEE   (Z80 snapshot, filetype from !MZX)
  45.          SP          :  225   (SP snapshot)
  46.          PRG         :  226   (PRG snapshot)
  47.          ZX          :  227   (ZX/KGB snapshot)
  48.          SpecProg    :  702   (ACH snapshot, filetype from !Speculator).
  49.  
  50. Inside this application:
  51.          !Boot, !Run, !Sprites,
  52.          Sprites, Messages,
  53.          !RunImage etc.     - You know what they are.
  54.  
  55.          c, h, o, Makefile  - All to do with the source for this version.
  56.  
  57.          Resources.RomImage - The rom image (spectrum.rom - see documentation).
  58.                               for conversions.
  59.          Doc                - Documentation of Spconv 1.07
  60.          Source             - Original source for Spconv 1.07
  61.  
  62.  
  63. Author:  RISC-OS conversion: Tim Moore (c) 1994
  64.          Original version: Henk de Groot (c)
  65.            (Contact: Henk de Groot - groot@apd.dec.com    or
  66.                      Henk de Groot - groot@idca.tds.philips.nl)
  67.  
  68. Acknowledgements:
  69.          !MZX and !Speculator authors for some of the filetypes and the
  70.          Sprites for the filetypes.
  71.  
  72. Some Archimedes ZX Spectrum Emulators:
  73.          !MZX (version 1.10 at this date) by Graham Willmott
  74.             Last known contact:
  75.                Graham Willmott   (se2044@bristol.ac.uk)   22 Apr 1994
  76.  
  77.          !Speculator, author unknown, availability unknown.
  78.             Apparently copies available should not be around.
  79.  
  80.  
  81. - ----------------------------------------------------------------
  82.      This application is PD.  You are free to copy and
  83.      distribute this in it's full application form, 
  84.      as long as my name is kept within it and any
  85.      alterations are aknowledged.
  86.      Please tell me of any alterations.
  87.  
  88.      Any source codes included are copyrighted to the
  89.      author(s) of them.
  90.  
  91.      Tim Moore ⌐ 1994
  92.  
  93. - ----------------------------------------------------------------
  94. If you wish to contact me then I can be mailed at ...
  95.  
  96.    Mr.T.Moore         
  97.    30 Meadow Rise
  98.    Dawlish
  99.    Devon
  100.    EX7 9AZ
  101.  
  102. Internet mail (University of Portsmouth):
  103.      sis1514@sisvax.sis.port.ac.uk
  104.  
  105. (Until July 1995)
  106. - ----------------------------------------------------------------
  107.  
  108. History:
  109.      v0.01 - Development version, no front-end. Changed source a little bit
  110.              to work under RISC-OS and to not use UNIX libraries (which caused
  111.              problems when combined with RISC_OSLib).
  112.              Also made the source a header/source set and changed the main
  113.              parameters (no 'main' anymore) so that it could be called
  114.              suitably from a 'front-end'. The source doesn't deal with
  115.              determining file types anymore.
  116.      v0.02 - Development version, with front-end. Did templates, wimp shell
  117.              and all those sort of things. Deal with 'drag-and-drop' loading
  118.              and saving, file type identification, calling the conversion
  119.              routines and saving from !Scrap. Doesn't support RAM loading/
  120.              saving events.
  121.      v1.00 - Release version. Added !Help and tidied up etc.
  122.  
  123.  
  124. Disclaimer:
  125.      Any problems and bugs with this program that may lead to your problems
  126.      are not my fault, but the fault of peoples instructions (or lack of) of
  127.      how to write wimp programs :-)
  128.  
  129.  
  130. PS:
  131.      Would someone like to provide a nice DDE compatible (not too heavy on the
  132.      memory and speed) C++ compiler WITH a SIMPLE set of window libraries
  133.      (ones that are EASY to use, but cover at least ALL features of
  134.      RISC OS 3.5 and can be backwards compatible for future versions of ROS,
  135.      PLUS are compliant to the style guide)?
  136.  
  137.      Also (even better) ... would someone like to do the same but for an Ada
  138.      compiler (pref. Ada 9X, like GNAT).
  139.      Ada is far superior, similar to Pascal (but better), very robust and
  140.      safe, EASY, perfect for OOD/OOP and has it's own (gorgeous) tasking
  141.      system!!!   Learn Ada I say!!!
  142.  
  143. PGP:
  144.      You can check my signatures using a trusted public key of mine.
  145.      A copy of my public key block is in the file 'pubkey', but you need
  146.      an independent trusted key to be sure.
  147.      (The signature for the !RunImage executable is RImage/sig. Check with
  148.      the command 'pgp RImage/sig !RunImage' or using a front-end application).
  149.  
  150. -----BEGIN PGP SIGNATURE-----
  151. Version: 2.3a
  152.  
  153. iQCVAgUBLos9D9Zm1AuttC5dAQEWEwP/akdUifOmD9XBqDVIFlG4c6tMiLSwwK5J
  154. rrp58W1zJx1yYpQ1e1HD53I6xEMPJnpDvJHOvmdVv5l0vi0UIvc3/KNqVzkwdN9q
  155. mn7w650bKzGgddiccs1ittaIb5aUOsHA+YbqFdQ+Mx+Dx8PlRxb+bXA4XgS1ilWJ
  156. wDJ1Z75QmW4=
  157. =W1yx
  158. -----END PGP SIGNATURE-----
  159.